home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / pcb / csp118.zip / CSPROFIL.DOC < prev    next >
Text File  |  1992-07-07  |  7KB  |  145 lines
  1.       (****************************************************)
  2.       (* CSProfile       Written by Gary Bouchard         *)
  3.       (* SysOp - The Computer Store BBS                   *)
  4.       (* St. Augustine, Florida (904)794-0063             *)
  5.       (* Copyright(c) 1990....All Rights Reserved         *)
  6.       (* Released May 26, 1992    Modified                *)
  7.       (****************************************************)
  8.  
  9.                          What is CSPROFILE?
  10.  
  11. CSProfile is a utility program written for use with PCBoard ver 14.5x.
  12. It's purpose is to provide information relating to files contained on
  13. the BBS like the date it was uploaded, who uploaded the file, last
  14. download date, how many times it was download. Among other features
  15. CSProfile will also allow you to gather personal data on all the files
  16. that you have downloaded/uploaded to the BBS, and the total number of
  17. bytes. Through security level permission, a user may also do zippy type
  18. scans for data. The data is obtained through PCBoards Download.txt file,
  19. and provides for seamless integration into PCBoards Main Menu commands.
  20.  
  21.                        Installation of CSProfile
  22.  
  23. For ease of operation, the following example may be used for
  24. installation and operation of CSProfile, however, you wizards may come
  25. up with a more efficient manner, which would not hurt my feelings in
  26. the slightest! (-:
  27.  
  28. 1)  Create a directory in which to place your executable programs and
  29.     configuration file. On my system I created a directory off of my PCB
  30.     directory called CSP.
  31.  
  32. 2)  Copy or unzip the contents of the CSP zip file into this directory,
  33.     and with a simple text editor, modify the csprofile.cnf to suit your
  34.     needs.
  35.  
  36.     Line 1 should always contain the word "INTERRUPT".
  37.  
  38.     line 2 should contain the default file extensions to use if the user
  39.     does not provide on on the command line in PCBoard.
  40.  
  41.     Line 3 is a user definable prompt to display to the user for
  42.     prompting file names.
  43.  
  44.     Line 4 is the level of security needed to enable the ZIPPY SCAN
  45.     feature of CSProfile.
  46.  
  47.     Line 5 is the starting date which is used to begin searches. This
  48.     date is used in the File Profile searches, and Zippy Searches, but
  49.     not used in the Personal History searches.
  50.  
  51.  
  52. 3)  Go into PCBoard setup, and select letter J - Main Board
  53.     Configuration. Press your cursor up key until you have highlighted
  54.     you DOORS Path/Name List file, then press function key F2. Move to
  55.     the bottom of the list with the cursor down key, the press ALT-I to
  56.     insert a new entry. Type "FI" or "FP" or whatever you wish your
  57.     command name to be, skip the password field (unless you want one),
  58.     and enter the security level which would be allowed to use this
  59.     program. Move to the USER.SYS field and answer "Y". Move to the
  60.     SHELL field and answer "Y", then move to the PATH TO DOOR FILES
  61.     field, and tell it where to find the batch file to start the
  62.     program. In order to provide the seamless integration with PCBoard
  63.     the program is run as a shelled program, which make it appear as
  64.     though the user never left PCBoard.
  65.  
  66. 4)  Edit your startup batch file to match that of the command that you
  67.     will use in pcboard to execute the program. On my board I use the
  68.     command "FI" for file information. I named my batch file "FI" and
  69.     keep it in the \pcb directory. Look at the example "FI" file that I
  70.     provided. Notice that instead of changing directories I simply
  71.     specify the full path and names like so;
  72.  
  73. @ECHO OFF
  74. C:\PCB\CSP\CSPROFILE.EXE C:\PCB\CSP\CSPROFILE.CNF C:\PCB
  75. ^^^^^^^^^^^^^^^^^^^^^^^  ^^^^^^^^^^^^^^^^^^^^^^^  ^^^^^^
  76. Path and name of prog.  path & name of config.  location of pcboard.dat
  77.  
  78. This makes execution of the program much quicker, and return is a breeze!
  79.  
  80. 5)  Edit your BBS menus to reflect this new command. I included a help
  81.     file in the ZIP which can be modified to your liking. Place the help
  82.     file in the \pcb\help directory. I put an .HLP extensions on it that
  83.     you need to remove for PCBOARD to be able to use it.
  84.  
  85.                         Operation of CSProfile
  86.  
  87. Operation of the program is easy. Once installed you can run the program
  88. by using the command and passing it a filename (wild cards *ARE*
  89. allowed!) or just typing the program name, which will present a small
  90. list of options. As an example, on my board I use the command "FI" for
  91. file information. For a user to get information about a particular file
  92. list DIRLIST.ZIP which contains my daily file listings, the user would
  93. type "FI DIRLIST <enter>".
  94.  
  95. The program assumes an extension as specified in the configuration file.
  96. Mine is set to ZIP so the extension of ZIP would be added onto the file
  97. name. If the filename is passed the program will go right to work and
  98. search for the file beginning with the start date specified in the
  99. configuration file. A series of dots appear next to the filename during
  100. the search indicating each time it reads a line in the download.txt
  101. file.
  102.  
  103. After it has completed the search the program returns the number of hits
  104. found in the file, then presents a small menu allowing the user to see
  105. all activity on that particular file, using the "S"how option, and the
  106. "D"isplay option will display when the file was originally uploaded, who
  107. uploaded it, the number of times downloaded, and the date of the last
  108. download. The Q"uit option returns them to the CSProfile prompt, where
  109. they can exit, scan for their personal stats, or if they have the proper
  110. security level, allow them to do a zippy scan through the download.txt
  111. file for certain text. Each of these options allows the "D"isplay, and
  112. "S"how menu options.
  113.  
  114.                       Registration of CSProfile
  115.  
  116. CSProfile is a *FREEWARE* program... That means that I do not charge for
  117. the use of this program, whoever I do maintain the rights to the program
  118. and should I choose to, sell it at any time. I *DO* however accept
  119. voluntary donations to the effort at any time on any of the PCBoard
  120. utilities that I have written!
  121.  
  122. CSProfile requires a keyfile for unrestrained operation. There is a
  123. slight delay in the transition from PCBoard to CSProfile for
  124. unregistered users. To obtain an unlimited, uninhibited keyfile, you
  125. simply need to call my BBS, and leave me a message or contact me via
  126. CHAT, and I'll make you one up right quick. The reason I require the
  127. keyfile is so that I know who is using the program, and I can gauge what
  128. type of response I get to the program. My BBS is a free access system
  129. also, upon registration. My BBS number is included in the box at the
  130. beginning of this document.
  131.  
  132. I write terrible documentation, but what do you want for free! (-:
  133.  
  134. If you have any difficulty operating the program, or need assistance, or
  135. have comments or suggestions, please feel free to drop me a line.
  136.  
  137.                              Future Releases
  138.  
  139. As of today, the only other features planned for this program are the
  140. ability to check the PCBoard filelist.idx to see if a file exist before
  141. doing a search.
  142.  
  143. If you have any additional features you would like to see drop me a
  144. line.
  145.